Skip to content

docs(planner): document lifecycle-aware planning and costs - #320

Closed
zzylol wants to merge 34 commits into
test/workload-lifecycle-e2efrom
docs/lifecycle-aware-planner
Closed

docs(planner): document lifecycle-aware planning and costs#320
zzylol wants to merge 34 commits into
test/workload-lifecycle-e2efrom
docs/lifecycle-aware-planner

Conversation

@zzylol

@zzylol zzylol commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Stacked on #319.

Why

Lifecycle semantics, costs, guarantees, and CSE interactions need an architectural contract.

Before this PR

No top-down document explained how workload evidence becomes a deployment or which integrations remain deferred.

After this PR

A designer can follow recurring demand through alternatives and cost formulas to a guarantee and explained rejection, including shared-summary costing.

What and how

  • Documents planner flow and semantics.
  • Defines cost factors and formulas.
  • Explains CSE and guarantees.
  • Separates current from deferred capabilities.
  • Documentation only.

Verification

  • Documentation checked against public types
  • Workspace formatting check

Stack

Base: #319. Next: #313.

@zzylol
zzylol force-pushed the test/workload-lifecycle-e2e branch from 2f4eb69 to ec4ce8f Compare August 30, 2026 18:21
@zzylol
zzylol force-pushed the docs/lifecycle-aware-planner branch from 5548824 to 15c2f5b Compare August 30, 2026 18:21
@zzylol
zzylol force-pushed the test/workload-lifecycle-e2e branch from ec4ce8f to 1056383 Compare August 30, 2026 18:30
@zzylol
zzylol force-pushed the docs/lifecycle-aware-planner branch from 15c2f5b to 0b81280 Compare August 30, 2026 18:30
@zzylol
zzylol force-pushed the test/workload-lifecycle-e2e branch from ed53588 to 3a660e9 Compare August 30, 2026 18:46
@zzylol
zzylol force-pushed the docs/lifecycle-aware-planner branch from e815908 to 347839f Compare August 30, 2026 18:46
zzylol and others added 15 commits August 30, 2026 13:02
…ase boundaries (#171)

Add phase-explicit post-ASAP nodes SummaryExpr::{ExactTransform, ExactPostProcess}
carrying a non-exhaustive ExactOperator::Aggregate payload (never an intact
QueryExpr subtree), plus an ExecutionAvailability {UpdateValue, SummaryState,
ReadoutValue} derivation/validation (post_asap::phase) returning typed
PhaseErrors at construction. construct_summary_agg now validates its edge, so
a maintained summary over a query-time readout falls back conservatively
instead of producing an unexecutable plan.

Add ExactCompositionStrategy (registered in default_strategies) proposing
Replacement::ExactComposition candidates that reference the child target
rather than selecting a child; PlanSpace::global_selection commits the
compatible parent/child pair using the issue's cost-units-per-second
formulas (postprocess/pretransform vs raw-recompute baseline), counts shared
child state once, and GlobalSelection::materialize links the committed
decisions into one validated DAG with shared Rc identity.

Cost hooks: CostModel::mixed_execution_capabilities and
exact_composition_cost_inputs (unknowns stay None, never zero; missing
statistics keep KeepPreAsap). DAG export gains explicit per-node stage,
decision provenance, cost unit and child-decision links (additive).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@zzylol
zzylol force-pushed the test/workload-lifecycle-e2e branch from 3a660e9 to a8fedf2 Compare August 30, 2026 19:03
@zzylol
zzylol force-pushed the docs/lifecycle-aware-planner branch from 347839f to 312ff5a Compare August 30, 2026 19:03
@zzylol
zzylol force-pushed the test/workload-lifecycle-e2e branch 2 times, most recently from bf0f818 to 4e93a30 Compare August 30, 2026 21:27
@zzylol zzylol closed this Aug 30, 2026
@zzylol

zzylol commented Aug 30, 2026

Copy link
Copy Markdown
Contributor Author

Superseded because this document still described the removed phase/value-operation model. The active stack documents the revised maintenance-mode design directly in #300, #316, #318, #319, and #313.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant